/*
 *  Copyright 2008 Mark Ashworth <javameme@gmail.com>.
 * 
 *  Licensed under the GNU General Public License v3 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 * 
 *       http://www.gnu.org/licenses/gpl-3.0.html
 * 
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 *  under the License.
 */
package xperiment.metaphor.model.entity;

import java.util.Date;
import xperiment.metaphor.model.Actor;
import xperiment.metaphor.model.Named;

/**
 * A person
 * @author Mark Ashworth <javameme@gmail.com>
 * @version 1.0.0
 */
public interface PersonActor extends Actor, Named {

    /**
     * The person's full name. This definition is shared with Named.
     * @return String
     */
    public String getName();
    
	/**
	 * The persons first name
	 * @return String
	 */
	String getFirstName();

	/**
	 * The persons first name
	 * @param firstName The new first name
	 */
	void setFirstName(String firstName);
	
	/**
	 * The persons last name
	 * @return String
	 */
	String getLastName();
	
	/**
	 * The persons last name
	 * @param lastName The new last name
	 */
	void setLastName(String lastName);
	
	/**
	 * The persons initials
	 * @return String
	 */
	String getInitials();

	/**
	 * The persons initials
	 * @param initials The new initials
	 */
	void setInitials(String initials);
	
	/**
	 * The persons date of birth
	 * @return Date
	 */
	Date getDateOfBirth();

	/**
	 * The persons date of birth
	 * @param dateOfBirth The new date of birth
	 */
	void setDateOfBirth(Date dateOfBirth);

	/**
	 * Sets the date of birth
	 * @param year The year
	 * @param month The months January == 1
	 * @param day The day
	 */
	void setDateOfBirth(int year, int month, int day);
	
	/**
	 * The persons gender
	 * @return Gender
	 */
	Gender getGender();

	/**
	 * The persons gender
	 * @param gender The new gender
	 */
	void setGender(Gender gender);
	
	/**
	 * Identity number
	 * @return String
	 */
	String getIdentityNo();

	/**
	 * Identity number
	 * @param identityNo The new identity number
	 */
	void setIdentityNo(String identityNo);

	/**
	 * The persons population group
	 * @return PopulationGroup
	 */
	PopulationGroup getPopulationGroup();

	/**
	 * The persons population group
	 * @param populationGroup The new population group
	 */
	void setPopulationGroup(PopulationGroup populationGroup);
}
